home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 3 / Light ROM 3 - Disc 2.iso / real3d / programs / tdd2real / tdd2real.lha / tddd2Real.doc < prev   
Text File  |  1995-01-09  |  4KB  |  70 lines
  1. tddd2Real v1.0 -- Documentation
  2.  
  3. ABSTRACT:
  4.      tddd2Real converts 3d-object files from TDDD format to Real3D v2.47 format, preserving
  5.      hierarchy and color information of the original object. The coordinates of the converted
  6.      object can be scaled to values between 0 and 1 in order to achieve optimal precision and
  7.      ease of use in Real3D.
  8.      The TDDD file is scanned by routines from the TDDD-Lib package by Glenn Lewis which
  9.      allows various conversions from Imagine┤s TDDD format (TDDD-Lib is available separately
  10.      on Aminet in gfx/3d).
  11.  
  12. LEGAL:
  13.      tddd2Real is FREEWARE by permission of Glenn Lewis; you can use and distribute it at
  14.      no cost but not for profit. Please note that TDDD-Lib itself is SHAREWARE.
  15.      If you find this program useful, please send me an E-mail to make me feel important...
  16.  
  17. WARNING:
  18.      This program is rather stable at this point, but is has only been tested on my computer.
  19.      So be sure not to work on anything important while you try it out and better use RAM:,
  20.      SD0: or a similar volatile data carrier during the conversion process.
  21.  
  22. REQUIREMENTS:
  23.      The program is written in ANSI-C and compiled with gcc v2.6.1 using the `-m68000`
  24.      switch, so in theory all you need is the ixemul library (version 40.4 or higher)
  25.      in your LIBS: directory. However, I was not able to test the program on any
  26.      computer other than my A4000, so if you run into problems send me an E-mail and
  27.      I will try to fix it.
  28.  
  29. USAGE:
  30.      The program should be started from CLI with
  31.  
  32.          `tddd2Real [-s(cale)]  [-n(o_hierarchy)] <TDDD-File>`
  33.  
  34.      (substitute a suiting filename for <...>). This will create a file "<TDDD-File.r3d>"
  35.      in your current working directory which can be used by Real3D (v2.47 or higher).
  36.      The two possible options are "-scale" ("-s" is enough) which suppresses autoscaling
  37.      and "-no_hierarchy" ("-n" is enough) which instructs tddd2Real to save the TDDD object
  38.      as one single Real3D TRISET, ignoring an existing hierarchy.
  39.  
  40. PROS:
  41.      The converted object is a so called TRISET Real3D primitive, which keeps file size,
  42.      memory usage and rendering speed down in comparison to numerous triangle primitives.
  43.      Furthermore you can ask Real3D to do a Phong shading with the object (by choosing
  44.      the menu `Modify/Freeform/Type`) which will produce a smoother look in rendering.
  45.  
  46. CONS:
  47.      The converted object is a so called TRISET Real3D primitive, which means that only
  48.      triangular modelled objects can be converted (no splines, spheres etc.). Additionally
  49.      it can only have a uniform color due to a limitation of Real3D. This color will be taken
  50.      from the original TDDD object, if possible.
  51.  
  52. PROBLEMS:
  53.      Are there any ? tddd2Real converts all of the objects on Aminet (in gfx/3dobj) correctly.
  54.      Sometimes all subobjects get black as default color and you have to set the proper color
  55.      manually but since I don┤t own Imagine, I can┤t tell if they are supposed to be black...
  56.  
  57. HINTS:
  58.      You can use `tddd2dxf` from TDDD-Lib and Realsoft┤s DxfToRPL to convert your objects
  59.      to separate triangles. As said before this type of conversion has its drawbacks, but
  60.      it allows you to unleash Real3D┤s particle system on your object (Explode it, blow it
  61.      away, etc.).
  62.  
  63. CREDITS:
  64.      Glenn "T3D" Lewis for his excellent TDDD-Lib. Without it, tddd2Real would not have been
  65.      possible.
  66.  
  67. AUTHOR:
  68.      Alexander Vilbig, microbiologist and computer scientist in spe
  69.      Send bug-reports, suggestions, etc. to vilbig@informatik.tu-muenchen.de
  70.